home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / help.arc / HELP.SYS < prev    next >
Text File  |  1985-08-18  |  6KB  |  143 lines
  1. · HELP.SYS07/07/84
  2. HELPDOC
  3.                         Configuring The Help Facility
  4.  
  5.  
  6.         The new SCP help facility can be easily tailored for OEM or
  7. end user needs. The program "HELP.COM" looks for a file "HELP.SYS" in
  8. the default directory, or through path searching. When distributed, HELP
  9. is located in the BIN directory with the rest of the command files.
  10.  
  11.         HELP.SYS is really just an ASCII text file with a few special
  12. control keys embedded for text manipulation. If you have a screen editor
  13. that can insert control characters (Control-C,etc.) ,such as VEDIT, then
  14. you can re-edit the file for your specific needs, such as special commands,
  15. further explanations. Explained below is how the text file is manipulated.
  16. 
  17.         HELP.COM searches for the file "HELP.SYS" on the default directory.
  18. If it is not found, the default environment will be searched for "PATH="
  19. then it will start path searches, just as the command processor does. If
  20. you have another application which uses the same filename "HELP.SYS" then you
  21. can rename the file,and with the debugger, you can change HELP.COM to search
  22. for another name. See explanation below.
  23.  
  24.         IF HELP finds the file, it opens it with XENIX type file calls. An
  25. 8K buffer is established and the 1st 8k of the file is read in. If there was
  26. no key or subkey typed when help starts up, the default menu is displayed.
  27. When a key is type (such as 'debug') HELP will search each 'record' until
  28. it finds that key. Case is ignored and the length of the key doesn't matter.
  29. You do not have to type the full key name for searching, it will just search
  30. for the 1st match of the key name entered. You need type a key only up to the
  31. first significant letter. For example:
  32.  
  33.                 "BAT"   Will find batch processing record.
  34.  
  35.                 "BAC"   Will find the backup record.
  36. 
  37.         Records are seperated from each other by a Control-A (01H). If there
  38. are subkeys for that record, (such as FIND OPTION) the subkey records have a
  39. Control-B at the beggining of the record. Records can be any length, if the
  40. text buffer fills up, it will automatically fill in more. When the proper
  41. record is found, text is display to the screen, a line counter keeps track
  42. of the number of lines. If the text fills more than 23 lines, the scrolling
  43. stops and waits for user (unless pause flag is disabled). The only non-alpha
  44. characters in the file are Control-D (04H) - page screen, and Control-C - end
  45. of file. A summary of the control keys is below:
  46.  
  47.                 Control-A       : Marks beginning of text record.
  48.  
  49.                 Control-B       : Marks beginning of sub-key text record.
  50.  
  51.                 Control-D       : Page screen (if pause flag). Stop text
  52.                                   writing and fill screen with blanks. Wait
  53.                                   for user entry to start. (Cleans up display
  54.                                   into desired screen pages)
  55.  
  56.                 Control-C       : End of file.
  57. 
  58.         The command line in help is a standard buffer and can use the
  59. standard DOS editing template keys. If a simple return is typed, the old
  60. template will not be lost. Typing a control-x while records are viewed will
  61. return the user to the help command level. You can return to DOS by typing
  62. control-C at any time, or "Q" or "QUIT" from the help command level.
  63.  
  64.         To speed up search of keys and simplify code, it is assumed that the
  65. keys are in alphanumeric order. If they are not, it will not find the key on
  66. the first pass and an error will be generated. It will find the key on the
  67. 2nd pass, but this is usually not a desired effect. If you add new records,
  68. make sure they are in alphabetical order.
  69.  
  70.  
  71.         Changing HELP.SYS to another name: Just rename the file with REN.
  72.  
  73.                 REN HELP.SYS  (Newname)
  74.  
  75.                 You must modify HELP.COM to search for another name. The
  76.                 debugger DEBUG.COM can do it. Type the following:
  77.  
  78.                 DEBUG \BIN\HELP.COM
  79.  
  80.                This will load in the help command file. Then type
  81.  
  82.                 D742
  83.  
  84.                 You should see:
  85.  
  86. d742
  87.  
  88. 0B7E:0740              48 45 4C 50-2E 53 59 53 00 00 00 00       HELP.SYS....
  89. 0B7E:0750  00 24 00 00 00 00 00 00-00 00 00 00 00 00 00 00   .$..............
  90. 0B7E:0760  00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00   ................
  91.  
  92.                 If you don't see the above, search any memory area nearby.
  93.                 You must only modify if you find "HELP.SYS". This is a
  94.                 reserved area for the filename. You can modify it by typing
  95.  
  96.                 E742    "(Newfilename)",0
  97.  
  98.                 E is the enter command, and 704 is the starting address for
  99.                 the text string. The new filename must be a maximum of 8
  100.                 characters for the filename and 3 for the extension. You must
  101.                 put a 0 at the end of the name.
  102. 
  103.                 Save your new HELP.COM by typing
  104.  
  105.                 W
  106.                 Q
  107.  
  108.                 Do not attempt to modify any registers or other memory
  109.                 locations as the program will not work then. All error
  110.                 messages will use the new filename you have just set up.
  111.  
  112.  
  113.  
  114.        NEW DOCUMENTATIN
  115.  
  116.  
  117.  
  118.         This program was originally written by me for Seattle Computer
  119. products. Some of the documentation in the help.sys will not apply to
  120. the IBM owners! I hope to download most of these programs (Count,Debug
  121. etc.) to the database in the near future as I know they will be useful
  122. to all PC lovers! Most of these programs were set up for generic
  123. MS-DOS machines and will be unfamiliar to the IBM world. Some of the programs
  124. were also distributed by IBM but I modified them at SCP for our own
  125. needs, since I had the source code to MS-DOS and its utilities.
  126.  
  127.         I hope to xmit most of these different programs sometime soon as
  128. I feel the whole community of users can use them, and since I no longer
  129. work at SCP I have complete rights to them! Enjoy it!
  130.  
  131.  
  132.                                         Craig Derouen
  133.                                         Seattle,Wa
  134. LDIR
  135.         Format LDIR name[.LBR]
  136.  
  137.         This will list the directory entries for the specified library.
  138. LTYPE
  139.         Format LTYPE name[.LBR] member
  140.  
  141.         This will list the specified member of the library on the screen
  142. 
  143.